home *** CD-ROM | disk | FTP | other *** search
/ Education (Super OZ Shareware) / Education (Super OZ Shareware).iso / arj / update.doc < prev    next >
Text File  |  1993-07-20  |  15KB  |  462 lines
  1.  
  2.      UPDATE.DOC, ARJ 2.41                    April 1993
  3.  
  4.  
  5.      This documents new or updated information since ARJ 2.30.
  6.  
  7.  
  8.      ** IMPORTANT NEWS ****************************************************
  9.  
  10.     The main changes to this release compared to ARJ 2.30 are faster
  11.     compression speed, a better security envelope, and improved
  12.     backup usage features.    There is a very slight improvement in
  13.     compression size.  For some users, there is a noticeable
  14.     improvement in processing speed with diskette based archives.
  15.  
  16.     ARJ uses a NEW SECURITY ENVELOPE scheme.  This version does NOT
  17.     recognize the previous envelope scheme nor will ARJ 2.39b and
  18.     before recognize the new security envelope scheme.  This is
  19.     INTENTIONAL as there exist hacks of the previous ARJ security
  20.     envelope.  You can use a previous version of ARJ to verify older
  21.     envelopes.
  22.  
  23.     The previous ARJ-SECURITY codes do not work with this new
  24.     version.  New codes and software will be mailed to ALL old and
  25.     new ARJ-SECURITY customers within weeks of this release.
  26.  
  27.     The ARJ listfile feature (!listfile) has a new option "-hl" to
  28.     display included filenames that cannot be found on the disk and
  29.     to subsequently return a non-zero errorlevel.
  30.  
  31.     The "-he" option from ARJ 2.39b has changed function.
  32.  
  33.     Software developers of programs which support the ARJ format
  34.     should take note of the following two changes.
  35.  
  36.     The self-extractor modules have been changed significantly.  The
  37.     standard ARJSFX module is 15K bytes in size.  A larger 17K
  38.     ARJSFX module supports ARJ-SECURITY.  The main ARJ header no
  39.     longer follows immediately after the EXE module.
  40.  
  41.     Various fields in the ARJ main header have been defined for use
  42.     at 2.39 and above.
  43.  
  44.     The large ARJSFX module will NOT prompt for permission to
  45.     continue the extraction if the "-e", "-x" or "-y" arguments have
  46.     been specified.
  47.  
  48.     The small ARJSFXJR module will count the skipping of files that
  49.     already exist as minor errors.    This ARJSFXJR skipping will
  50.     generate a DOS errorlevel of 1, while other errors will generate
  51.     a DOS errorlevel of 2.    However, with the new "-n" command line
  52.     option, ARJSFXJR will not count skips as an error.  The ARJSFXJR
  53.     module now supports command line options.
  54.  
  55.     To prevent novices from using ARJ to update a multiple volume
  56.     archive, ARJ will not allow a multiple volume update unless the
  57.     new "-hu" option has been specified.  Only multiple volume experts
  58.     should try updating these type of archives.
  59.  
  60.     The "-y" option no longers suppresses the multiple volume prompt
  61.     when the volume resides on a removable media drive such as a
  62.     diskette drive.  You can suppress the volume prompt with "-jyv".
  63.  
  64.     The processing of "-jy" and "-v" switch options have been
  65.     improved to be consistent with other switch processing.
  66.  
  67.     The ARJ yes/no query prompts have been changed to have a local
  68.     and a global effect.  See the USER PROMPTS section below.
  69.  
  70.     A new user prompt has been added just before asking for a new
  71.     filename during extraction when not overwriting.
  72.  
  73.     Whenever archiving to diskettes, it is HIGHLY recommended that the
  74.     option "-jt" be used.  This helps spot BAD diskettes or BAD
  75.     diskette drives.  It is HIGHLY recommended that the "-jt" option
  76.     be used in a multi-tasking or network environment.
  77.  
  78.     The command "ARJ e -d archive *.*" will now prompt for permission
  79.     to complete the deletion.
  80.  
  81.     Unless the "-jr" (recover) switch is used, ARJ will delete any file
  82.     extracted with a CRC or Bad file data error.
  83.  
  84.     The "m" (move) command and "-d" option will NOW delete directories
  85.     selected with the "-a1" option.
  86.  
  87.     UNERASE or UNDELETE commands do not always recover a file
  88.     correctly.  This will result in damaged archives.  This is true
  89.     for all archive types.    You should always test an archive after
  90.     unerasing it.
  91.  
  92.     If you use the software disk cache, HYPERDISK, see the KNOWN ARJ
  93.     ISSUES section in ARJ.DOC for important information.
  94.  
  95.      **********************************************************************
  96.  
  97.  
  98.      USER PROMPTS
  99.  
  100.     The ARJ user prompts have been improved to provide more
  101.     flexibility.  In addition to the normal yes and no responses, ARJ
  102.     also accepts the following responses: quit, always, skip, global,
  103.     and command.
  104.  
  105.     "Global" sets ARJ to inhibit all subsequent user prompts by assuming
  106.     YES for all queries as if "-y" were specified.
  107.  
  108.     The "Always" response has changed.  It now sets ARJ to assume YES
  109.     for subsequent queries of the same class.  For example, answering
  110.     YES to the overwrite query will assume YES for ALL subsequent
  111.     overwrite queries.
  112.  
  113.     "Skip" sets ARJ to assume NO for ALL subsequent queries of the same
  114.     class.
  115.  
  116.     Subsequent user prompt messages will still be output to the screen
  117.     after the "always" and "skip" responses but no user response will be
  118.     accepted.
  119.  
  120.     "Command" prompts for one DOS command and then executes it.  ARJ
  121.     then returns to expect an answer to the current yes/no query.  You
  122.     should keep the query in mind as ARJ does NOT always redisplay
  123.     the full query message.
  124.  
  125.  
  126.      ARJ ERROR LEVELS
  127.  
  128.     ARJ will now return a DOS errorlevel of 9 when trying to process a
  129.     file that is NOT an ARJ archive.
  130.  
  131.     With the new option "-hl", ARJ will return a non-zero errorlevel
  132.     when a user specified filename from within an ARJ listfile cannot
  133.     be found on disk.  Ordinarily, ARJ returns no error for such a
  134.     situation.
  135.  
  136.  
  137.      ARJ ARCHIVE NAME WILDCARDING
  138.  
  139.     ARJ allows the wildcarding of the archive parameter for ARJ
  140.     commands other than the add commands (a, f, j, m, u).  If the "-r"
  141.     option is specified, ARJ will scan through subdirectories looking
  142.     for ARJ archives to process.
  143.  
  144.     This feature allows a user to delete a specific file from a series
  145.     of archives.
  146.  
  147.     Example:  ARJ d *.ARJ bbs.ad
  148.  
  149.     This feature could also be used to extract a series of archives.
  150.  
  151.     Example:  ARJ e *.ARJ
  152.  
  153.  
  154.      ARJ COMMAND LINE PROCESSING
  155.  
  156.     The option "-x-" will now ignore any previous "-xfilename" options.
  157.  
  158.  
  159.      ARJSFX COMMAND LINE PROCESSING
  160.  
  161.     The larger ARJ self-extractor (-je) supports the new command line
  162.     option "-s" to allow the skipping of the ARJ-SECURITY envelope
  163.     verification test if an envelope exists.
  164.  
  165.  
  166.      ARJSFXJR COMMAND LINE PROCESSING
  167.  
  168.     The small ARJ self-extractor (-je1) supports command line
  169.     options.
  170.  
  171.     ARJSFXJR [-switch(es)] [drive:][target_dir\]
  172.  
  173.     switches:
  174.     n: set ARJSFXJR to NOT count as an error the skipping of files
  175.     o: set ARJSFXJR to overwrite existing files
  176.  
  177.     You can specify a target_directory or drive or both.  However,
  178.     you must specify the ending "\" or ":" symbol.
  179.  
  180.     ARJSFXJR -o C:\SOFT\  -> self-extract into directory "C:\SOFT\"
  181.                  in overwrite mode.
  182.  
  183.  
  184.      ARJ COMMANDS
  185.  
  186.      "a" command
  187.  
  188.     When adding files that replace files in an archive, ARJ will now
  189.     display a "Replacing " message to indicate an overwrite.
  190.  
  191.  
  192.      "e" and "x" commands
  193.  
  194.     When overwriting a file, ARJ will display file size and date-time
  195.     information concerning the ARJ file and the DISK file.
  196.  
  197.  
  198.      "p" command
  199.  
  200.     When using the ARJ "p" command to redirect output to a viewer
  201.     program such as "LIST", ARJ will now set the date-time stamp of
  202.     the intermediate temporary file to the date of the archived file
  203.     as opposed to the current date and time.
  204.  
  205.  
  206.      ARJ SWITCHES
  207.  
  208.      "-b3" switch
  209.  
  210.     The "-b3" switch is used to reset the archive bits of files being
  211.     extracted.  It is useful for setting the archive state so that a
  212.     subsequent incremental backup will not backup these extracted
  213.     files.
  214.  
  215.  
  216.      "-d" switch
  217.  
  218.     The "-d" switch when used during extraction with the wildcard "*.*"
  219.     will prompt the user for permission to delete the files.  This
  220.     prompt can be suppressed with the "-y" or "-jyd" options.
  221.  
  222.  
  223.      "-i2" switch
  224.  
  225.     The "-i2" switch sets ARJ to display a combined percentage and
  226.     bar progress display.
  227.  
  228.  
  229.      "-m" switch
  230.  
  231.     The "-m1" and "-m2" compression methods have been modified to
  232.     improve the compression ratios.
  233.  
  234.  
  235.      "-od" switch
  236.  
  237.     The "-od" switch sets ARJ to select files no older than the
  238.     specified number of days.  The days are calculated from midnight.
  239.  
  240.     Examples:  ARJ a archive -od0     select files modified today
  241.            ARJ a archive -od1     select files modified yesterday
  242.                      and today
  243.  
  244.  
  245.      "-v" switch
  246.  
  247.     When the multiple volume ARJ files to be used are located on drives
  248.     with removable media (diskette drives, etc.), ARJ will ALWAYS
  249.     PROMPT for the next diskette even with the "-y" option specified.
  250.     However, you can suppress the next volume prompt with the "-jyv"
  251.     option.  At DOS versions before 3.0, only drives A and B are
  252.     considered removable.
  253.  
  254.     After the pause to change diskettes, ARJ will check to make sure
  255.     that the diskette has been changed.  However, this check is limited
  256.     to 3 retries for the same volume.
  257.  
  258.     ARJ will not allow the updating of multiple volume archives unless
  259.     the "-hu" option is specified.
  260.  
  261.     The "r" modifier allows the reservation of disk space on the first
  262.     volume.  The number after the "r" specifies the space to reserve.
  263.     This is useful for software installation volumes built on the hard
  264.     disk.
  265.  
  266.     Example:  ARJ a install -v360r50K   make first volume 50000 bytes
  267.                         smaller than 360K.
  268.  
  269.     Example:  ARJ u archive -v360u
  270.  
  271.     The "z" modifier works like the "s" modifier except that the system
  272.     command is NOT echoed to the screen.
  273.  
  274.     The "-v" switch now accepts its modifiers in any order.  The "s"
  275.     and "z" modifiers must be last because any succeeding text is
  276.     considered the system command to execute.
  277.  
  278.     Examples:  ARJ a volume -vavw         beep, autosize, whole files
  279.            ARJ a volume -vavsDIR     beep, autosize, execute DIR
  280.  
  281.  
  282.      "-w" switch
  283.  
  284.     When using the "-w" switch while archiving to multiple volumes, ARJ
  285.     will check the available disk space in the work directory.  If
  286.     there is not enough space, ARJ will prompt for permission to
  287.     continue.  This prompt can be suppressed with the "-y" and "-jyd"
  288.     switches.
  289.  
  290.  
  291.      "-y" switch
  292.  
  293.     The "-y" switch will no longer suppress the "-v" next volume prompt
  294.     when the archive is located on a drive with removable media such as
  295.     a diskette drive.
  296.  
  297.  
  298.      "-ja1" switch
  299.  
  300.     The "-ja1" switch will suppress the display of the archive comment.
  301.  
  302.  
  303.      "-jn" switch
  304.  
  305.     The "-jn" switch is used to restart a multiple volume archive.    The
  306.     index file created by the "-ji" switch at ARJ 2.39 and above can be
  307.     used to facilitate restarting.    Please note that index files
  308.     created by older versions of ARJ will not work with this restart
  309.     method.  This method uses the "-jn" syntax without a filename.    The
  310.     previously written index file is scanned to determine the restart
  311.     information.
  312.  
  313.     To use this method of restarting, you must specify the "-ji" switch
  314.     to build an index file while archiving to multiple volumes.  To
  315.     restart an interrupted sequence, simply specify the EXACT SAME
  316.     command line as before and add "-jn".  ARJ will determine the
  317.     archive name, the restart filename, and the restart file position.
  318.  
  319.     Example:  ARJ a a:volume -va c:\*.* -r -jiINDEX.FIL
  320.           ARJ a a:volume -va c:\*.* -r -jiINDEX.FIL -jn
  321.  
  322.  
  323.      "-jp" switch
  324.  
  325.     The "-jp" switch will be ignored if the ARJ output has been
  326.     redirected as in "ARJ l archive -jp > dump".
  327.  
  328.  
  329.      "-jr" switch
  330.  
  331.     The "end of file" error message will no longer be displayed when
  332.     using the "-jr" option on a valid ARJ archive.
  333.  
  334.  
  335.      "-jr1" switch
  336.  
  337.     The "-jr1" switch should be used when "-jr" switch usage cannot
  338.     access some files in a damaged archive because of a premature end
  339.     of archive marker.
  340.  
  341.  
  342.      "-jy" switch
  343.  
  344.     The "-jy" switch options are now parsed like other switches with
  345.     regard to toggling and the "+/-" modifiers.  You can also specify
  346.     multiple occurrences of the "-jy" options.
  347.  
  348.     Examples:  -jyo -jyo    evaluates to no change
  349.            -jyo -jyo+    evaluates to suppress overwrite prompt
  350.            -jyo+c+y+    evaluates to suppress overwrite and create
  351.                 prompts and use single key input mode
  352.  
  353.  
  354.      "-ha" switch
  355.  
  356.     The "-ha" switch sets ARJ to reset the attributes of a file to be
  357.     overwritten or a file to be deleted.  This allows the overwrite or
  358.     delete operation to proceed.
  359.  
  360.     A slight performance degradation may result from using this option.
  361.  
  362.     Examples:  ARJ e archive -ha
  363.            ARJ m archive -ha dir\*.*
  364.  
  365.  
  366.      "-hc" switch
  367.  
  368.     The "-hc" switch sets ARJ to execute a DOS command at the start of
  369.     the execution of ARJ immediately after the command line switch
  370.     options have been processed, but before the wildcard search is
  371.     started.  This can be used to clear the screen to hide the command
  372.     line or to provide a pause option to allow swapping diskettes.
  373.  
  374.     Examples:  ARJ a -hcCLS archive -gpassword
  375.            ARJ a -hcPAUSE archive *.*
  376.  
  377.  
  378.      "-he" switch
  379.  
  380.     The "-he" switch sets ARJ to skip the verification procedure when
  381.     accessing an ARJ-SECURED ARJ archive.  This verification procedure
  382.     is time consuming and need only be done once to be sure of the
  383.     integrity of the archive.
  384.  
  385.  
  386.      "-he1" switch
  387.  
  388.     The "-he" switch sets ARJ to abort with an error code of 4 when
  389.     processing a possibly ARJ-SECURED archive.  This is useful as a
  390.     REARJ.CFG option for ARJ.  This will prevent REARJ from converting
  391.     an ARJ-SECURED archive to the same or another format.
  392.  
  393.     Examples:  ARJ l secured.arj -he1
  394.  
  395.  
  396.      "-hi" switch
  397.  
  398.     The "-hi" switch when used with the "-ji" switch sets ARJ to
  399.     include the file date-time stamp, the original file size, the
  400.     compressed file size, the compression ratio, and the filename in
  401.     the index file.
  402.  
  403.     Example:  ARJ a a:backup c:\*.* -r -va -jiINDEX -hi
  404.  
  405.  
  406.      "-hl" switch
  407.  
  408.     The "-hl" switch sets ARJ to report the "file not found" type of
  409.     errors when processing the filenames in an ARJ listfile during an
  410.     "add" type command (a, f, m, u).  ARJ will subsequently return a
  411.     non-zero DOS errorlevel when such an error has been found.
  412.     Previous versions of ARJ ignored these types of errors.
  413.  
  414.     Example:  ARJ a a:backup !listfile -va -hl
  415.  
  416.  
  417.      "-hs" switch
  418.  
  419.     The "-hs" switch sets ARJ to disable its file sharing support.
  420.     This may be necessary for some unusual applications.
  421.  
  422.  
  423.      "-hu" switch
  424.  
  425.     The "-hu" switch sets ARJ to allow the updating of multiple volume
  426.     archives.  At this revision, by default, ARJ does not allow
  427.     updating of multiple volume archives because of the possibility of
  428.     losing data.
  429.  
  430.     Example:  ARJ c archive -hu -zcomment.txt
  431.  
  432.  
  433.      "-hw" switch
  434.  
  435.     The "-hw" switch sets the ARJ w command to display the
  436.     "Searching ..." filenames messages in a scroll saving format.
  437.     Filenames of files that do not contain string matches will be
  438.     overwritten on the screen.
  439.  
  440.     The "-hw1" switch sets the ARJ w command to ONLY display the
  441.     "Searching ..." filenames messages for files that contain string
  442.     messages.
  443.  
  444.  
  445.      "-hx" switch
  446.  
  447.     The "-hx" switch allows the user to specify what the default file
  448.     extension or extensions that are to be used by ARJ to access
  449.     archive names that are not specified with file extensions.  ARJ
  450.     will assume that the first extension specified will be the main
  451.     default extension.
  452.  
  453.     Examples:  ARJ a archive *.* -hx.SDN   assumes default .SDN
  454.                            file extension
  455.            ARJ l archive -hx.SDN.ARJ   looks for archive.SDN and
  456.                            if not found, then looks
  457.                            for archive.ARJ
  458.  
  459.  
  460.      end document
  461.  
  462.